feat: Add `base44 logs` command #193

ozsay · 2026-02-04T15:23:32Z

Note

Description

Adds a unified base44 logs command that fetches and displays both app audit logs (workspace events like entity changes, deployments, user actions) and function runtime logs (console output from Deno Deploy) in a single time-sorted view. Supports filtering by function name, log level, time range, with pagination and JSON output for scripting.

Related Issue

None

Type of Change

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to not work as expected)
Documentation update
Refactoring (no functional changes)
Other (please describe):

Changes Made

Added src/core/logs/ module with fetchAuditLogs() API and Zod schemas for workspace audit events
Extended src/core/resources/function/ with fetchFunctionLogs() to retrieve runtime console logs via Deno Deploy proxy
Implemented base44 logs CLI command with filtering options: --function, --level, --since, --until, -n/--limit, --order, --json
Smart message formatting for 15+ audit event types (entities, functions, users, auth, access, automation, integrations, agents)
Automatic function discovery from project config when --function not specified
Human-readable table output with color-coded log levels, timestamps, and line wrapping
Added comprehensive test suite (13 test cases) covering all filtering scenarios and error cases
Extended testkit with mockAppInfo, mockAuditLogs, mockFunctionLogs API mocks

Testing

I have tested these changes locally
I have added/updated tests as needed
All tests pass (npm test)

Checklist

My code follows the project's style guidelines
I have performed a self-review of my own code
I have commented my code, particularly in hard-to-understand areas
I have made corresponding changes to the documentation (if applicable)
My changes generate no new warnings
I have updated AGENTS.md if I made architectural changes

Additional Notes

Tests are currently pending in CI. The implementation follows existing patterns for commands (factory functions with CLIContext), API clients (authenticated base44Client), and resource modules. Level filtering uses semantic mapping: info maps to successful audit events, error to failures, while debug/warn skip audit logs entirely and only show function logs at those levels.

_{🤖 Generated by Claude | 2026-02-08 20:15 UTC}

github-actions · 2026-02-04T15:24:03Z

🚀 Package Preview Available!

Install this PR's preview build with npm:

npm i @base44-preview/cli@0.0.28-pr.193.5a0ab06

Prefer not to change any import paths? Install using npm alias so your code still imports base44:

npm i "base44@npm:@base44-preview/cli@0.0.28-pr.193.5a0ab06"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/cli@0.0.28-pr.193.5a0ab06"
  }
}

📦 Preview Package: @base44-preview/cli@0.0.28-pr.193.5a0ab06
🔗 View this commit on GitHub

_{Preview published to npm registry — try new features instantly!}

claude · 2026-02-04T15:28:55Z

Code review

Found 1 issue to address:

CLAUDE.md Documentation Missing

The PR adds a new logs/ module under src/core/ with schema, API, and core functionality, but CLAUDE.md is not updated to document this architectural change.

CLAUDE.md Rule (line 659):

"Keep AGENTS.md updated - Update this file when architecture changes"

What needs updating:

Folder structure section (lines 32-140) should include the new logs/ module:

├── core/
│   ├── logs/                 # Audit logs (NEW)
│   │   ├── schema.ts         # Zod schemas for audit log types
│   │   ├── api.ts            # API functions for fetching logs
│   │   └── index.ts

Module documentation - Consider adding a "Logs Module" section similar to the Site Module documentation that explains:
- Architecture overview
- Key functions (fetchAuditLogs(), getWorkspaceId())
- Workspace-level vs app-level logs
- CLI command usage

This documentation helps AI agents understand the logs architecture when working on related features.

claude · 2026-02-04T15:32:39Z

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

claude · 2026-02-04T15:34:44Z

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

The PR correctly implements the base44 logs command following all established patterns in the codebase.

- Shorten timestamp to readable format (YYYY-MM-DD HH:MM:SS) - Adjust column widths for better alignment - Dim the timestamp for visual hierarchy Co-authored-by: Cursor <cursoragent@cursor.com>

Co-authored-by: Cursor <cursoragent@cursor.com>

kfirstri · 2026-02-09T11:22:37Z

src/cli/commands/logs/index.ts

+    );
+
+    // Filter by level if specified (API doesn't support level filtering)
+    const filteredLogs = filters.level


pass this to the API

kfirstri · 2026-02-09T11:23:06Z

src/cli/commands/logs/index.ts

+  }
+
+  // Sort by time (respecting order option)
+  const order = options.order?.toUpperCase() === "ASC" ? 1 : -1;


CLI should be stupid as possible, if we can get this form BE its best

ozsay changed the title ~~Add base44 logs command~~ feat: Add base44 logs command Feb 4, 2026

ozsay marked this pull request as draft February 5, 2026 08:06

Paveltarno mentioned this pull request Feb 4, 2026

Add OAuth connectors as a CLI resource #184

Open

6 tasks

kfirstri added this to CLI Development Feb 5, 2026

github-project-automation bot moved this to Backlog in CLI Development Feb 5, 2026

ozsay force-pushed the logs-commands branch from d8f9f74 to d945491 Compare February 8, 2026 12:25

ozsay and others added 12 commits February 8, 2026 17:10

add base44 logs command

d58ec8a

fix: improve logs table formatting

842dc9f

- Shorten timestamp to readable format (YYYY-MM-DD HH:MM:SS) - Adjust column widths for better alignment - Dim the timestamp for visual hierarchy Co-authored-by: Cursor <cursoragent@cursor.com>

fix: correct status colors - dim success, highlight failure

0996ba2

Co-authored-by: Cursor <cursoragent@cursor.com>

add base44 functions logs command

edd3b8f

consolidate commands

7778431

restore files

965d3ff

fix import

a51c6e9

work on logs

cf689fc

refactor

dbe86f5

lint

2f8ea4a

fix bugs

2f13a6a

lint

afcc270

ozsay force-pushed the logs-commands branch from 66923b8 to afcc270 Compare February 8, 2026 15:10

lint

33a6297

ozsay marked this pull request as ready for review February 8, 2026 15:28

Merge branch 'main' into logs-commands

819884b

kfirstri reviewed Feb 9, 2026

View reviewed changes

dor-chaouat moved this from Backlog to In review in CLI Development Feb 9, 2026

dor-chaouat moved this from In review to In progress in CLI Development Feb 9, 2026

ozsay added the invalid This doesn't seem right label Feb 11, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Add `base44 logs` command #193

feat: Add `base44 logs` command #193

Uh oh!

ozsay commented Feb 4, 2026 •

edited by claude bot

Loading

Uh oh!

github-actions bot commented Feb 4, 2026 •

edited

Loading

Uh oh!

claude bot commented Feb 4, 2026

Uh oh!

claude bot commented Feb 4, 2026

Uh oh!

claude bot commented Feb 4, 2026

Uh oh!

kfirstri Feb 9, 2026

Uh oh!

kfirstri Feb 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

feat: Add base44 logs command #193

Are you sure you want to change the base?

feat: Add base44 logs command #193

Uh oh!

Conversation

ozsay commented Feb 4, 2026 • edited by claude bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Related Issue

Type of Change

Changes Made

Testing

Checklist

Additional Notes

Uh oh!

github-actions bot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Package Preview Available!

Uh oh!

claude bot commented Feb 4, 2026

Code review

CLAUDE.md Documentation Missing

Uh oh!

claude bot commented Feb 4, 2026

Code review

Uh oh!

claude bot commented Feb 4, 2026

Code review

Uh oh!

kfirstri Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

kfirstri Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

feat: Add `base44 logs` command #193

feat: Add `base44 logs` command #193

ozsay commented Feb 4, 2026 •

edited by claude bot

Loading

github-actions bot commented Feb 4, 2026 •

edited

Loading